home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu173.dms / pu173.adf / Docs / lhasfx.man.pp / lhasfx.man
Text File  |  1992-03-20  |  6KB  |  302 lines
  1.  
  2.  
  3.      
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                             LhASFX User's Guide
  15.  
  16.                  Evaluation Version 1.0 - 22 November 1991
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.              ###      ###       #####    #####   ##### ##    ##
  33.               ##       ##      ###  ##  ###  ## ###     ##  ##
  34.               ##       ##      ##   ##  ##      ##      ##  ##
  35.               ##       #####   #######   #####  ####     ####
  36.               ##       ##  ##  ##   ##      ### ##      ##  ##
  37.               ##   ##  ##  ##  ##   ##  ##   ## ##      ##  ##
  38.              #######  ###  ### ##   ###  #####  ##     ##    ##
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                           Written by Stefan Boberg
  57.                     Copyright (c) 1991 by Stefan Boberg
  58.  
  59.  
  60.      
  61.  
  62.  
  63.      V1.0                   LhASFX User's Guide                  Page 1
  64.  
  65.  
  66.  
  67.  
  68.      0 - LhA      
  69.  
  70.         LhASFX is  part  of the LhA family of programs.  The same rules
  71.      applies  to  this  program as LhA - read the `politics' section of
  72.      the  manual for more information.  When you register yourself as a
  73.      user  of  LhA,  you  automatically register as a user of LhASFX as
  74.      well, and will receive updates at the same time as LhA updates.  
  75.  
  76.  
  77.      1 - Introduction      
  78.  
  79.         LhASFX sole  purpose  in  life  is  to  create SFX-archives.  A
  80.      SFX-archive  is  a  normal  LhA  archive with a special executable
  81.      SFX-header  prepended to it, which makes it possible to list, test
  82.      and  extract  files  from  the  archive  by means of executing it.
  83.      Those  of  you who have used LHA or ARJ on MSDOS machines probably
  84.      know  what  it  is.  It was written primarily to provide me with a
  85.      good  way  of  distributing  my LhA package on BBS'es, FidoNet and
  86.      other  computer networks. I think it is rather silly to distribute
  87.      an  archiver  in an archive-file, since you then will need another
  88.      archiver,  which  may also be archived and so on..  I've even seen
  89.      examples  where the archiver was distributed in an archive created
  90.      by itself! :) 
  91.  
  92.         There are  other  similar  programs  for the Amiga, but none as
  93.      fast,  flexible  and  efficient as LhASFX.  The other programs use
  94.      compression  methods  that  have  a much smaller compression ratio
  95.      than  that  of  LhASFX,  and  use  their  own archive file format.
  96.      LhASFX  uses  the  standard  LhArc/LhA  archive format, and LhASFX
  97.      archives  can  easily  be converted to standard LhArc/LhA archives
  98.      with  a  simple  command  ('UnSFX',  part  of the LhA package), or
  99.      manipulated with the LhA archiving program directly.  
  100.  
  101.         Another advantage  LhASFX  has  compared  to other archivers is
  102.      that  LhASFX  handles  archives  of  any  size in only 48K of RAM.
  103.      While  other programs load the entire archive into memory at once,
  104.      LhASFX loads the data when it needs it.  
  105.  
  106.      2 - System requirements     
  107.  
  108.         The LhASFX  program  will run on any Amiga system with at least
  109.      512KB RAM and one diskdrive.  
  110.  
  111.         The SFX-Module  only  uses  about 48K memory when decompressing
  112.      or   listing   archives,   regardless   of   archive   size.   The
  113.      decompression  routines  of the SFX-module are less optimized than
  114.      those  of  the real archiver LhA, because I consider size as being
  115.      more  important  than  speed  in  this  case  (it  still  is fast,
  116.      anyway!).  
  117.  
  118.  
  119.  
  120.      
  121.  
  122.  
  123.      V1.0                   LhASFX User's Guide                  Page 2
  124.  
  125.  
  126.      3 - How to use it   
  127.  
  128.         Using the  LhASFX program to create SFX archives is simple, the
  129.      command line syntax is as follows: 
  130.  
  131.      LhASFX <Archive> [<destfile>] 
  132.  
  133.  
  134.         Where <Archive>  is  the  name  of  the  archive  you  wish  to
  135.      convert,  with  or  without  the  `.lha' or `.lzh' extension.  The
  136.      optional  <destfile>  is  the  name  of the file you would like to
  137.      hold  the  SFX  archive.   If  no  <destfile> is specified, LhASFX
  138.      takes  the basename of <Archive> (i.e.  strips any extensions) and
  139.      appends  a  `.run'  suffix  to  it  to  indicate  that  it  is  an
  140.      executable  SFX  file.   If  you  specify a <destfile> without the
  141.      `.run'  extension  LhASFX  will  put one there.  DO NOT DISTRIBUTE
  142.      LhASFX ARCHIVES WITH ANY OTHER SUFFIX THAN `.RUN' PLEASE!! 
  143.  
  144.  
  145.      4 - Limitations of the SFX module  
  146.  
  147.         The SFX  module  only  handles  the -lh5- and -lh4- compression
  148.      modes,  and  of course stored files (-lh0-).  It does *NOT* handle
  149.      the   old   -lh1-  compression  mode.   If  you  want  to  make  a
  150.      SFX-archive  of  an  archive  which  uses  the  -lh1- compression,
  151.      simply  use the LhA `c' command to convert to `-lh5-' compression,
  152.      or  repack the normal way (unpack somewhere and then pack it again
  153.      with the -2 switch).  
  154.  
  155.         The SFX module does NOT handle multiple-volume archives.  
  156.  
  157.         This is  the  evaluation  version  of  LhASFX,  and it does not
  158.      contain  all features that the `real' version registered LhA users
  159.      get.   The  `real' LhASFX contains some more switches, and the SFX
  160.      module is smaller.  
  161.  
  162.         The registered  version  also  contains  an  advanced integrity
  163.      check algorithm that is VERY difficult to bypass.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.      
  181.  
  182.  
  183.      V1.0                   LhASFX User's Guide                  Page 3
  184.  
  185.  
  186.      5 Politics       
  187.  
  188.         For disclaimers,  licensing  information  etc., please refer to
  189.      the user's manual for the LhA archiver.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.      
  241.  
  242.  
  243.      
  244.  
  245.  
  246.                              Table Of Contents
  247.  
  248.                                 LhASFX V1.0
  249.  
  250.      0 - LhA     ................................................    1
  251.      1 - Introduction     .......................................    1
  252.      2 - System requirements    .................................    1
  253.      3 - How to use it  .........................................    1
  254.      4 - Limitations of the SFX module ..........................    2
  255.      5 Politics      ............................................    3
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                                    - I -
  301.  
  302.